package com.chushouya.manager.service.common;

import com.chushouya.common.wx.dto.WxSchemeRequest;
import com.chushouya.common.wx.dto.WxSchemeResponse;

/**
 * 微信小程序服务
 * 
 * @author shouboshi
 * @date 2025-01-23
 */
public interface WxMiniProgramService {

    /**
     * 生成微信小程序 URL Scheme
     * 适用于短信、邮件、外部网页、微信内等拉起小程序的业务场景
     * 
     * @param appId 小程序AppId
     * @param request URL Scheme 请求参数
     * @return 生成的 scheme 响应
     */
    WxSchemeResponse generateScheme(String appId, WxSchemeRequest request);

    /**
     * 生成永久有效的微信小程序 URL Scheme（简化版）
     * 
     * @param appId 小程序AppId
     * @param path 小程序页面路径
     * @param query 页面参数
     * @return 生成的 scheme 码
     */
    String generateSchemeSimple(String appId, String path, String query);
}
